home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 3.iso / dist / fw_openssl.idb / usr / freeware / catman / p_man / cat3 / BN_new.Z / BN_new
Text File  |  2001-01-10  |  3KB  |  133 lines
  1.  
  2.  
  3.  
  4.      BBBBNNNN____nnnneeeewwww((((3333))))            22226666////JJJJaaaannnn////2222000000000000    ((((0000....9999....6666))))             BBBBNNNN____nnnneeeewwww((((3333))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       BN_new, BN_init, BN_clear, BN_free, BN_clear_free - allocate
  10.       and free BIGNUMs
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.        #include <openssl/bn.h>
  14.  
  15.        BIGNUM *BN_new(void);
  16.  
  17.        void    BN_init(BIGNUM *);
  18.  
  19.        void    BN_clear(BIGNUM    *a);
  20.  
  21.        void    BN_free(BIGNUM *a);
  22.  
  23.        void    BN_clear_free(BIGNUM *a);
  24.  
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.       _B_N__n_e_w() allocated and initializes a BBBBIIIIGGGGNNNNUUUUMMMM structure.
  28.       _B_N__i_n_i_t() initializes    an existing uninitialized BBBBIIIIGGGGNNNNUUUUMMMM.
  29.  
  30.       _B_N__c_l_e_a_r() is    used to    destroy    sensitive data such as keys
  31.       when they are    no longer needed. It erases the    memory used by
  32.       aaaa and    sets it    to the value 0.
  33.  
  34.       _B_N__f_r_e_e() frees the components of the    BBBBIIIIGGGGNNNNUUUUMMMM,    and if it was
  35.       created by _B_N__n_e_w(), also the    structure itself.
  36.       _B_N__c_l_e_a_r__f_r_e_e() additionally overwrites the data before the
  37.       memory is returned to    the system.
  38.  
  39.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEESSSS
  40.       _B_N__n_e_w() returns a pointer to    the BBBBIIIIGGGGNNNNUUUUMMMM. If the allocation
  41.       fails, it returns NNNNUUUULLLLLLLL and sets an error code    that can be
  42.       obtained by ERR_get_error(3).
  43.  
  44.       _B_N__i_n_i_t(), _B_N__c_l_e_a_r(), _B_N__f_r_e_e() and _B_N__c_l_e_a_r__f_r_e_e() have no
  45.       return values.
  46.  
  47.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  48.       bn(3), err(3)
  49.  
  50.      HHHHIIIISSSSTTTTOOOORRRRYYYY
  51.       _B_N__n_e_w(), _B_N__c_l_e_a_r(),    _B_N__f_r_e_e() and _B_N__c_l_e_a_r__f_r_e_e() are
  52.       available in all versions on SSLeay and OpenSSL.  _B_N__i_n_i_t()
  53.       was added in SSLeay 0.9.1b.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                        (printed 11/10/00)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      BBBBNNNN____nnnneeeewwww((((3333))))            22226666////JJJJaaaannnn////2222000000000000    ((((0000....9999....6666))))             BBBBNNNN____nnnneeeewwww((((3333))))
  71.  
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.      Page 2                        (printed 11/10/00)
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.